home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 23 / Amiga Format AFCD23 (Feb 1998, Issue 107).iso / -in_the_mag- / emulation / computers / mission / mission.txt < prev    next >
Text File  |  1997-12-12  |  6KB  |  135 lines
  1.                           ******* Mission *******
  2.                    The ColecoVision Emulator for the MSX
  3.                                 Version 1.1
  4.                                      
  5.                     Copyright (C) 1996  Marcel de Kogel
  6.  
  7. Hardware and Software Requirements
  8. ==================================
  9. An MSX1 with 64K RAM minimum (an MSX2 is recommended)
  10. MSX-DOS
  11. Some ColecoVision ROM images
  12. Both PSG and SCC and up to two joysticks are supported. The emulator will
  13. automatically detect and use an SCC cartridge in either slot 1 or 2
  14.  
  15. Files included
  16. ==============
  17. mission.com The emulator
  18. mission.txt This file
  19. coleco.rom  ColecoVision OS ROM image. Since the emulator makes some
  20.             assumptions of where certain OS routines are located, you may
  21.             not be able to use different OS ROM images
  22. The latest version of Mission can always be found on the Mission
  23. distribution site at http://www.komkon.org/~dekogel/mission.html
  24.  
  25. Note
  26. ====
  27. Since the program emulates a ColecoVision by patching the OS ROM, many
  28. games will not run on the emulator. About 1/3rd of all images I've tested
  29. run correctly, a few more run, but with flaws (e.g. corrupted graphics or
  30. sound). Also, because the MSX is significantly slower than the
  31. ColecoVision, you may find fewer games run correctly if you're using a
  32. 60Hz (NTSC) display. If you're having trouble running some games, try
  33. switching to 50Hz mode
  34.  
  35. Key Mappings
  36. ============
  37. F1           -  Pause emulation
  38. F2           -  Continue emulation
  39. F4           -  Quit emulator (only works on MSX2 systems) to 40 column
  40.                 text mode. Please note that this will not work properly if
  41.                 you started the emulator in 80 column mode
  42. SELECT       -  Quit emulator (only works on MSX2 systems) to 80 column
  43.                 text mode. Please note that this will not work properly if
  44.                 you started the emulator in 40 column mode
  45. F5           -  ColecoVision reset switch
  46. STOP         -  Toggle slow mode. For all cheaters out there
  47. INS          -  Map keyboard to joystick port #1 (default)
  48. DEL          -  Map keyboard to joystick port #2
  49. Cursor keys  -  Joystick movement
  50. Space, M     -  Joystick first button
  51. N            -  Joystick second button
  52. B            -  Joystick third button
  53. V            -  Joystick fourth button
  54. 0-9          -  Keypad key buttons
  55. -            -  Keypad * button
  56. =            -  Keypad # button
  57.  
  58. Starting the emulator
  59. =====================
  60. To start the emulator, simply type MISSION <filename> <ENTER>. If no
  61. filename is given, the emulator will load and execute CART.ROM, if
  62. present. The extension of your game ROM images is assumed to be .ROM. If a
  63. file CART.PAT is present, the emulator will load it and use it to patch
  64. CART.ROM
  65.  
  66. Patch file format
  67. =================
  68. The patch file (*.PAT) format is as follows:
  69. String "Mission Patch File",$1A
  70. Word   Size of ROM image in bytes
  71. Word   ROM image checksum. This is the sum of all bytes in the image
  72. Word   Number of patches to apply
  73. Patch data follows and has this format:
  74. Word   Offset in image of this patch
  75. Byte   New value
  76.  
  77. Creating patch files
  78. ====================
  79. Below are some addresses useful for those who want to create patch files:
  80. Offset Type        Contents/Function
  81. ------ ----        -----------------
  82. $3f00  String      "MISSION"
  83. $3f07  Byte        Emulator version number. The high nibble contains the
  84.                    major version number, the low nibble the minor version
  85.                    number. Currently, this byte contains $11
  86. $3f10  Byte        Current joypad #1 status
  87. $3f11  Byte        Current keypad #1 status
  88. $3f12  Byte        Current joypad #2 status
  89. $3f13  Byte        Current keypad #2 status
  90. $3f14  Byte        Current VDP status byte. Calling the READ_VDP_STATUS
  91.                    routine ($1fdc) modifies this; using this routine is
  92.                    highly recommended
  93. $3f80  Subroutine  Send A to the sound chip, you can also use location
  94.                    $335. Please note that calling this function does not
  95.                    change the PSG/SCC settings
  96. $3f83  Subroutine  Interpret sound chip data, this is called at every
  97.                    interrupt
  98. $3f86  Subroutine  Update current controller statuses. This is also called
  99.                    by the interrupt routine
  100. The subroutines do not change any register unless specified otherwise, and
  101. use no stack space
  102. If the upper two bits of the first byte of a cartridge image are both
  103. cleared, the lower bits have the following function:
  104. Bit Function
  105. --- --------
  106. 0   This game does not use the VDP_OUT routine ($1fd9) to set VDP register
  107.     #1. Setting this bit ensures interrupts are passed to the cartridge
  108.     NMI handler
  109. 1-5 Reserved
  110. If the first instruction of a game (the one pointed to by [$800a])is LD
  111. SP,nnnn; the emulator will replace it with LD SP,$7ff0. If a game runs out
  112. of stack space, try changing the first instruction, or add a LD SP,nnnn
  113. instruction somewhere in it's initialisation routine. ColecoVision RAM is
  114. at $7000-$73ff, all other memory between $4000-$7fff can be used freely
  115.  
  116. Legal issues
  117. ============
  118. This software can be used free of charge and may be distributed freely, as
  119. long as the archive isn't modified in any way, no profit is made from
  120. distributing it, and no game ROMs are supplied with it. Also, this
  121. software comes without any warranty, neither express nor implied: Use at
  122. your own risk
  123.  
  124. History
  125. =======
  126. 1.1  31-12-1996   Some (minor) bug fixes, added slow mode, keyboard can
  127.                   now be mapped to joystick port #2, improved SCC support
  128.                   and added 80 column support, removed separate NTSC
  129.                   version, pause feature stabilised, added support for
  130.                   patch files
  131. 1.0  30-11-1996   Initial release
  132.  
  133. Please send your comments to Marcel at
  134. m.dekogel@student.utwente.nl
  135.